home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / comm / prtcs155.zip / AUXSHELL.DOC < prev    next >
Text File  |  1994-01-14  |  4KB  |  112 lines

  1. $VER: AUXshell DOC Remote CLI and DOOR Handling     Williamson 55.01
  2.     
  3.  
  4.     AUX HANDLERS
  5.         I've  only  worked  with  the  Citadel AUX:  handler, which is
  6. based upon Steve Drew's AUX handler. However, both should work.
  7.  
  8.     For more info file request these from FidoNet#1:167/104.0:
  9.         CTDLAUX.LHA
  10.         AUXSUPPORT_V2.LHA
  11.     The above are also available via FTP from AmiNet.
  12.  
  13.         Neither allows changing device or unit, so I have provided two
  14. versions  of  ctdl-handler,one  for serial.device and one modified for
  15. artser.device.  Both are for unit 0.  Just copy the one yiu need to L:
  16. and  rename to ctdl-handler.  If you use some other serial device, Hex
  17. edit  the  handler to change the device name.  Unfortunatly, I have no
  18. idea how to change the unit number.
  19.  
  20.  
  21.     REMOTE SHELL
  22.  
  23.     Presently the Shell feature requires CTDL-AUX: device.
  24.  
  25.     *Gen.CFG:
  26.             SYSOPPW TESTPW
  27.     You must set ENV:TESTPW (AND ENVARC:TESTPW !!) to the password you
  28. wish to use to start the remote shell. This password may be a string.
  29.  
  30.     eg: You could run in this your startup sequence..
  31.     S:SetPW
  32.         SetEnv TESTPW golemstrikes
  33.         SetEnv golemstrikes "My precious"
  34.         copy env:testpw envarc:
  35.         copy env:golemstrikes envarc:
  36.  
  37.     Launching
  38.         The mailer does a case-sensitive compare of user input against
  39. the  contents  of the Env:  variable whoese NAME is stored in the ENV:
  40. variable defined by SYSOPPW keyword.  (confused?:) If this variable is
  41. undefined, it defaults to SYSOPPW and is empty.
  42.  
  43.     eg:
  44.         Cmp $(namebuf) "${${TESTPW}}" ; this gets the value of the env
  45.                                       ; variable, the name of which is 
  46.                                       ; stored in ENV:TESTPW
  47.         TrueJump loadshell
  48.         ....
  49.  
  50.             If the user types: My precious , the shell will be
  51.         launched.
  52.         ....
  53.  
  54.         loadshell:
  55.         Set user TRUE username "THE SYSOP"
  56.         RexxMsg "RY,SY" REXX "Address COMMAND \"Execute Mail:Scripts/AUXCLI\""
  57.         Jump do_menu
  58.  
  59.         The  user  and  username  variables  are  set so that bulletin
  60.     display and username prompt are bypassed.
  61.  
  62.     Mail:scripts/AUXcli  
  63.         ;       Script to  be executed from wpl to start remote shell
  64.         ;       Saves its process number, starts-up the remote shell
  65.         ;       and waits up to 30 mins for a BREAK.
  66.         SetEnv AUXWAIT $process
  67.         NEWCLI from Mail:Scripts/AuxCLI-Startup CTDL-AUX:
  68.         ; If we exit now, control will go back to mailer allowing it 
  69.         ; to muck up the serial port. So wait for newcli'd process to exit.
  70.         Wait 30 min       ; wait until timeout or exiting aux process kills us
  71.         echo >CTDL-AUX:endcli
  72.         UnSetENV AUXWait
  73.         ;return to wpl
  74.  
  75.  
  76.     Mail:scripts/AUXcli-Startup
  77.         ;       Startup-Script executed by AUXCLI
  78.         ;       Sets a QUIT alias which will issue a BREAK command to
  79.         ;       AUXcli.
  80.         ;       You may run a more secure shell such as CSH or AXsh
  81.         ;       from this script. (See Steve Drews' AUXSUPPORT.LHA)
  82.         failat 99
  83.         stack 10000
  84.         alias quit "break >nil: $auxwait c"
  85.  
  86.  
  87.     Mail:scripts/AUXkill     
  88.         Echo >CTDL-AUX:endcli   ;End AUX cli
  89.  
  90.     DOORS
  91.  
  92.           Any  CLI  door  or  program which can be exited with a BREAK
  93. command  may  be  used.  The i/o will be redirected to the modem using
  94. the  CTDL-AUX:   device.  DOOR.wplrx starts Carrier.rexx asyncronously
  95. to  monitor  the  CARRIER  of  the  line and then starts the door.  If
  96. carrier  drops while a door is active, a BREAK command will be sent to
  97. the door.
  98.  
  99.         The  description  field  must  be  in quotes.  The door launch
  100. command  does  not  require  enclosing quotes, but any embedded quotes
  101. that the door may require, must be escaped with a backslash.
  102.  
  103.          "description"                     launch command      
  104.  DOOR    "Adventure in The Collossal Cave" DOORS:adv/adventure
  105.  DOOR    "StarTrek"                        RexxC:rx DOORS:StarTrek \"$$(username)\"
  106.  DOOR    "Grin of the Day"                 RexxC:rx Rexx:rexxdoors/Grin_du_Jour
  107.  DOOR    "Fortune"                         RexxC:rx Rexx:rexxdoors/Your_Fortune
  108.  
  109.  
  110.  
  111.     -eot-
  112.